Skip to content

gf3d - doc: user manual chapter on Green function databases - #893

Merged
danielpeter merged 1 commit into
SPECFEM:develfrom
lsawade:gf3d-docs
Oct 6, 2026
Merged

danielpeter merged 1 commit into
SPECFEM:develfrom
lsawade:gf3d-docs

Conversation

@lsawade

@lsawade lsawade commented Oct 5, 2026

Copy link
Copy Markdown
Contributor

New chapter 8, "Green Function Databases", after "Doing tomography". It is a starting point, written for users who have run the solver but not built a database, in plain English:

  • introduction: the sparse reciprocal database, related work (Zhao et al. 2006, Ding et al. 2021, Simute et al. 2022, Sawade et al. 2024), the classic strain contraction, and the same sum written with per-source weights, which is what the extraction computes;
  • generating a database: the six GF_* Par_file entries and their defaults, GF_LOCATIONS, one FORCESOLUTION per station and direction (depth = burial in km), the database source time function, and the files written;
  • extracting seismograms: the STF correction hdur_corr = sqrt(hdur^2 - hdur_db^2), the element cache, xgf3d, and a minimal Fortran program and Python script;
  • the global end-to-end example in EXAMPLES/green_function_database.

Four figures from Sawade et al. (2024): data fit with and without 3D synthetics, conventional vs reciprocal computation, and the elements and GLL points selected for the GCMT catalog.

Chapters 8-14 move to 9-15 (file renames and \include lines only). bibliography.bib gains Sawade2024, ekstrom2012global, Zhao2006, Simute2022 and Ding2021.

The tracked manual PDF is not regenerated in this commit.

Acceptance:

  • pdflatex + bibtex build of the manual: chapter 8 is Green Function Databases, Noise is chapter 9; no warnings in the new chapter and no undefined references or citations.
  • the Python script runs on the global example database and prints what its comments say; the Fortran program compiles with the documented link line and runs on the same database.

New chapter 8, "Green Function Databases", after "Doing tomography".
It is a starting point, written for users who have run the solver but
not built a database, in plain English:

- introduction: the sparse reciprocal database, related work (Zhao et
  al. 2006, Ding et al. 2021, Simute et al. 2022, Sawade et al. 2024),
  the classic strain contraction, and the same sum written with
  per-source weights, which is what the extraction computes;
- generating a database: the six GF_* Par_file entries and their
  defaults, GF_LOCATIONS, one FORCESOLUTION per station and direction
  (depth = burial in km), the database source time function, and the
  files written;
- extracting seismograms: the STF correction
  hdur_corr = sqrt(hdur^2 - hdur_db^2), the element cache, xgf3d, and a
  minimal Fortran program and Python script;
- the global end-to-end example in EXAMPLES/green_function_database.

Four figures from Sawade et al. (2024): data fit with and without 3D
synthetics, conventional vs reciprocal computation, and the elements
and GLL points selected for the GCMT catalog.

Chapters 8-14 move to 9-15 (file renames and \include lines only).
bibliography.bib gains Sawade2024, ekstrom2012global, Zhao2006,
Simute2022 and Ding2021.

The tracked manual PDF is not regenerated in this commit.

Acceptance:
- pdflatex + bibtex build of the manual: chapter 8 is Green Function
  Databases, Noise is chapter 9; no warnings in the new chapter and no
  undefined references or citations.
- the Python script runs on the global example database and prints what
  its comments say; the Fortran program compiles with the documented
  link line and runs on the same database.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@danielpeter
danielpeter merged commit 12457ff into SPECFEM:devel Oct 6, 2026
40 of 41 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants